home *** CD-ROM | disk | FTP | other *** search
/ CBM Funet Archive / cbm-funet-archive-2003.iso / cbm / geos / util / misc / KeyMaker-2.1.lnx / KeyMaker 2.0 doc (.txt) next >
Encoding:
GEOS ConVerT  |  1999-06-16  |  27.9 KB  |  352 lines

  1. kEYmAKER 2.0 DOC
  2. prg FORMATTED geos FILE v1.0
  3. wRITE iMAGE v2.1
  4. GEOwRITE    v2.1
  5. .iRV cOBB
  6. 5107 n. 15TH sT.
  7. oMAHA, ne 68110
  8. *****
  9. **.****R**
  10. {$60}*(@*
  11. *1****Sa***9 v&******
  12. (MORE) =>
  13. kEYmAKER 2.0 IS AN APPLICATION THAT ALLOWS THE USER TO REDEFINE ALMOST ANY KEY ON THE 64 OR 128 KEYBOARD.
  14. kEYmAKER IS COMPATIBLE WITH gEOS 2.0 AND gEOS 128 2.0 IN 40 COLUMN MODE.  fULL SUPPORT OF THE 128 KEYBOARD IS INCLUDED.
  15. (MORE) =>
  16. iN 64 MODE, THE TOP HALF OF THE kEYmAKER SCREEN LOOKS LIKE THIS (128 USERS SEE 128 NOTES SECTION):
  17. nOTICE THAT THE "BACK ARROW" ICON IS INVERTED.  tHIS MEANS IT IS CURRENTLY SELECTED FOR EDITING.  tHE BACK ARROW KEY IS SELECTED WHEN kEYmAKER IS FIRST RUN AND AFTER THE USE OF load, save, AND default.
  18. aLSO NOTE THAT THE "SHIFT LOCK" AND "RESTORE" KEYS ARE SHADED.  tHESE TWO KEYS CANNOT BE EDITED WITHIN THE gEOS ENVIRONMENT.
  19. cLICK ON ANY KEY TO SELECT IT.
  20. (MORE) =>
  21. cCAN BE SELECTED TOGETHER WITH OTHER KEYS.  tHESE KEYS WILL CHANGE THE VALUE SHOWN IN THE status WINDOW NEXT TO "cURRENT:".  wHEN THE ctrl AND/OR 
  22.  KEYS ARE HIGHLIGHTED, THE fetch, dEFAULT, AND HEX EDITING ARROWS HAVE NO EFFECT.  tHIS IS BECAUSE VALUES FOR THESE KEYS ARE 
  23. CALCULATED
  24.  BY gEOS RATHER THAN HELD IN A LOOKUP TABLE.  tHUS, THEY CANNOT BE CHANGED.  (aCTUALLY, THE VALUES FOR A FEW OF THE 
  25.  KEYS COMBINATIONS ARE IN A LOOKUP TABLE, BUT kEYmAKER DOES NOT SUPPORT THEM.  sORRY.)  aLL OTHER ICONS ON THE kEYmAKER SCREEN WILL FUNCTION NORMALLY WHETHER OR NOT THESE KEYS ARE SELECTED.
  26. (MORE) =>
  27. dKEYS ALSO CAN BE USED IN CONJUNCTION WITH OTHER KEYS.  aS YOU MIGHT EXPECT, tHIS WILL SELECT THE SHIFTED VALUE OF THE KEY.  aLL OF THE ICONS ON THE kEYmAKER SCREEN FUNCTION WHEN shift IS SELECTED.
  28. nOTE: SOME KEYS RETURN THE SAME VALUE WHETHER SHIFTED OR UNSHIFTED.  hOWEVER, THE SHIFTED AND UNSHIFTED VALUES OF THESE KEYS CAN BE CHANGED AND MADE DIFFERENT FROM EACH OTHER.
  29. (MORE) =>
  30. tHE LOWER HALF OF THE kEYmAKER SCREEN LOOKS LIKE THIS:
  31. lET'S CONSIDER THE THREE SECTIONS OF THE status BOX FIRST.
  32. (MORE) =>
  33. tHE CENTER SECTION OF THE status BOX LOOKS LIKE THIS:
  34.  @kEY:
  35.   sHOWS THE KEY CURRENTLY SELECTED.  tHE KEY DESCRIPTION WILL BE IN CAPS IF THE shift KEY IS SELECTED, LOWER CASE IF NOT.  sOME OF THE ABBREVIATIONS USED FOR THE NON-ALPHA-NUMERIC KEYS ARE NOT TERRIBLY INTUITIVE.  iF THE ABBREVIATIONS CONFUSE YOU, LOOK AT THE TOP HALF OF THE SCREEN TO SEE WHICH KEY IS INVERTED OR SEE aPPENDICES a AND b.
  36.  @dEFAULT:
  37.   sHOWS THE DEFAULT VALUE (IN HEX) OF THE KEY SELECTED.
  38.  @cURRENT:
  39.   sHOWS THE CURRENT VALUE OF THE KEY SELECTED.  tHE VALUE DISPLAYED WILL CHANGE WHEN THE ctrl AND/OR 
  40.  KEYS ARE SELECTED, BUT THE VALUE IN MEMORY WILL NOT.
  41.  @hEX EDITING ARROWS:
  42. fcLICKING ON THESE ARROWS WILL CHANGE THE 
  43. CURRENT
  44.  VALUE OF THE SELECTED KEY.  tHE LEFT ARROWS WILL CHANGE THE HIGH NIBBLE, THE RIGHT ONES THE LOW NIBBLE.  
  45.  @tHESE CHANGES ARE MADE DIRECTLY TO THE gEOS LOOKUP TABLE AND WILL REMAIN IN EFFECT WHEN YOU quit kEYmAKER.
  46. aLTHOUGH kEYmAKER USES HEX VALUES EXCLUSIVELY, i HAVE TRIED TO MAKE IT COMPREHENSIVE ENOUGH THAT YOU DON'T NEED TO KNOW WHAT THE HEX NUMBERS MEAN TO USE THEM.  iF YOU DO NEED TO CONVERT HEX TO/FROM DECIMAL, aPPENDIX e INCLUDES BOTH VALUES FOR ALL THE KEYBOARD KEYS [$01 - $7E (1 - 126)]
  47. (MORE) =>
  48. tHE LEFT SIDE OF THE status BOX LOOKS LIKE THIS:
  49. cLICKING ON THE stash ICON WILL SAVE THE 
  50.  @CURRENT
  51.  KEY VALUE TO A BUFFER.
  52. cLICKING ON THE fetch ICON WILL REPLACE THE 
  53.  @CURRENT
  54.  KEY VALUE WITH THE VALUE IN THE BUFFER.
  55. tHE BUFFER STATUS INDICATOR BOX:
  56. iWILL BE TOTALLY INVERTED AFTER A stash.  aFTER THE FIRST fetch FROM THE BUFFER, THE INDICATOR BOX WILL BE HALF INVERTED.  tHIS GIVES YOU A VISUAL INDICATOR OF WHAT YOU HAVE DONE WITH THE BUFFER.
  57. tHE cornfield ICON:
  58. jWILL SHOW YOU THE CREDIT DIALOG BOX FOR kEYmAKER (SIMILAR TO PAGE ONE OF THESE DOCS.)
  59. (MORE) =>
  60. tHE RIGHT SIDE OF THE status BOX LOOKS LIKE THIS:
  61. cLICKING ON THE dEFAULT ICON WILL RETURN THE 
  62.  @CURRENT
  63.  KEY VALUE TO ITS DEFAULT.  dO NOT CONFUSE THIS ICON WITH THE 
  64.  @dEFAULT
  65.  ICON WHICH IS OUTSIDE THE status BOX!
  66. (MORE) =>
  67. tHE ICONS ON THE RIGHT SIDE OF THE BOTTOM OF THE SCREEN FUNCTION AS FOLLOWS:
  68. GEOS:pUTS UP A DIALOG BOX SHOWING THE dESK aCCESSORIES AVAILABLE ON DISK.  sECOND DRIVE AND DISK SWITCHING ARE ALSO SUPPORTED.
  69.  @dEFAULT:
  70. rETURNS ALL KEYS ON THE KEYBOARD TO THEIR DEFAULT gEOS VALUES.  tHIS ACTION IS not REVERSIBLE WITHOUT RE-EDITING OR loadING A kEYmAKER DATA FILE.  bE CAREFUL NOT TO CONFUSE THIS 
  71.  @dEFAULT
  72.  ICON WITH THE dEFAULT ICON IN THE status BOX!
  73.  @sAVE:
  74. sAVES YOUR CUSTOMIZED KEYBOARD SETUP TO A DATA FILE.  kEYmAKER USES auto_exec FILES AS DATA FILES.  save CREATES A STAND-ALONE gEOS FILE THAT WILL INSTALL YOUR CUSTOM KEYBOARD SETUP WHEN DOUBLE-CLICKED FROM THE dESKtOP (OR AT BOOT TIME IF PLACED ON YOUR BOOT DISK).
  75.  @lOAD:
  76. lOADS kEYmAKER DATA FILES FOR EDITING.  loadING A DATA FILE WILL CHANGE THE VALUES OF ALL KEYS TO THOSE SPECIFIED IN THE DATA FILE.  tHESE CHANGES ARE MADE DIRECTLY TO THE LOOKUP TABLE AND WILL REMAIN IN EFFECT WHEN YOU quit kEYmAKER.
  77.  @qUIT:
  78. cLICKING ON THE quit ICON WILL EXIT kEYmAKER.  uPON EXITING, THE KEYBOARD WILL BE CONFIGURED EXACTLY AS SPECIFIED BY THE 
  79.  @CURRENT
  80.  VALUES OF ALL KEYS.
  81. (MORE) =>
  82.  @128 nOTES
  83. tHE UPPER PART OF THE SCREEN WILL INCLUDE KEY ICONS REPRESENTING THE 128'S EXTRA KEYS:
  84. kKEYS WILL APPEAR IN THEIR CORRECT PLACE AT THE TOP OF THE KEYBOARD.  nOTE THAT THE caps lock AND 40/80 KEYS ARE SHADED.  tHEY CANNOT BE EDITED.
  85. tHE KEYPAD WILL APPEAR UNDERNEATH THE SPACE BAR ICON LIKE THIS:
  86. kEYPAD KEYS HAVE THEIR OWN SPOTS IN THE LOOKUP TABLE, EVEN THOUGH THEY DUPLICATE KEYS ON THE MAIN KEYBOARD.  tHUS THEIR VALUES CAN BE CHANGED INDEPENDENTLY.  iN THE status BOX, KEYPAD KEYS ARE REPRESENTED WITH A "K" SUFFIX TO DIFFERENTIATE BETWEEN THE KEYPAD AND MAIN KEYBOARD:
  87.  @kEY:
  88.  3     (3 KEY ON MAIN KEYBOARD ABOVE "W" AND "E")
  89.  @kEY:
  90.  3  K  (3 KEY ON KEYPAD)
  91. auto_exec DATA FILES CREATED IN 128 MODE WILL DO NOTHING IF RUN IN 64 MODE (AND VICE VERSA).  tHEY CAN BE DISTINGUISHED BY THE "64" OR "128" IN THE ICON.  kEYMAKER WILL LOAD ANY DATA FILE REGARDLESS OF WHICH MODE IT IS BEING RUN IN. iF A 128 FILE IS loadED IN 64 MODE AND THEN saveD, IT WILL HAVE BEEN CONVERTED TO A 64 auto_exec FILE AND THE KEYPAD DATA WILL BE LOST.  64 MODE DATA FILES CAN BE LOADED IN 128 MODE, BUT THE EFFECTS ON THE EXTRA 128 KEYS ARE UNPREDICTABLE.
  92. (MORE) =>
  93.  @pROGRAMMERS' NOTES:
  94. sOMETIMES gEOS SOFTWARE READS THE KEYBOARD DIRECTLY WITHOUT LOOKING IN THE QUEUE.  aN EXAMPLE IS THE dESKtOP'S 
  95.  shift a COMBINATION WHICH SWITCHES DRIVE c AND DRIVE a.  
  96.  shift a HAS A VALUE OF $C1.  hOWEVER, IF YOU DEFINE A KEY AS $C1, THE dESKTOP WILL RESPOND TO IT AS IF YOU PRESSED 
  97.  a (WITHOUT THE SHIFT).
  98. pROFUSE THANKS TO mIKE sCHELL FOR HIS FILE DOCUMENTING THE gEOS KEYBOARD ROUTINES.  kEYmAKER WOULD HAVE BEEN IMPOSSIBLE WITHOUT HIS WORK.
  99. eVEN THOUGH i HAVE YET TO MAKE A DIME ON THE "sHAREWARE cONCEPT", i'LL ASK AGAIN . . .
  100. kEYmAKER 2.0 IS SHAREWARE.  iF YOU GET SIGNIFICANT USE FROM THIS PROGRAM (AND REMEMBER THAT A DATA FILE MAY BE USED EVERY TIME YOU BOOT), PLEASE SEND $5.00 (i'M REALLY NOT GREEDY, BUT i 
  101.  USE THE ENCOURAGEMENT!) TO:
  102.  @iRV cOBB
  103.  @5107 n 15TH sT.
  104.  @oMAHA, ne  68110
  105. AND THANKS!
  106. (MORE) =>
  107.  @aPPENDIX a
  108. uNSHIFTED kEY aBBREVIATIONS
  109. DELDELETERETRETURN
  110. CRTCURSOR RIGHTCDNCURSOR DOWN
  111. LBBRITISH POUNDHOMHOME
  112. ^ UP ARROWBACBACK ARROW
  113. SPCSPACESTPSTOP
  114.  @128 ONLY:
  115. HLPHELPTABTAB
  116. 1 KKEYPAD 12 KKEYPAD 2
  117. 3 KKEYPAD 34 KKEYPAD 4
  118. 5 KKEYPAD 56 KKEYPAD 6
  119. 7 KKEYPAD 78 KKEYPAD 7
  120. 9 KKEYPAD 90 KKEYPAD 0
  121. + KKEYPAD PLUS- KKEYPAD MINUS
  122. . KKEYPAD PERIODNSCNO SCROLL
  123. ESCESCAPELFDLINE FEED
  124. ENTENTERALTALT
  125. UPCURSOR UP *DWNCURSOR DOWN *
  126. LEFCURSOR LEFT *RGTCURSOR RIGHT *
  127. * oN THE 128, THE CURSOR KEYS ON THE UPPER LEVEL OF THE KEYBOARD CAN BE DEFINED SEPARATELY FROM THOSE ON THE MAIN KEYBOARD.
  128. (MORE) =>
  129.  @aPPENDIX b
  130. sHIFTED kEY aBBREVIATIONS
  131. insINSERT (SHIFT DELETE)retRETURN
  132. clfCURSOR LEFTcupCURSOR UP
  133. lbBRITISH POUNDclrCLEAR (SHIFT HOME)
  134. ^ UP ARROWbacBACK ARROW
  135. spcSPACErunRUN (SHIFT STOP)
  136. SH0SHIFT ZEROSH+SHIFT PLUS
  137. SH-SHIFT MINUSSH@SHIFT @
  138. SH*SHIFT ASTERISKSH=SHIFT EQUAL SIGN
  139. quoQUOTES (SHIFT 2)SH^SHIFT UP ARROW
  140.  @128 ONLY:
  141. hlpHELPtabTAB
  142. 1 kKEYPAD 12 kKEYPAD 2
  143. 3 kKEYPAD 34 kKEYPAD 4
  144. 5 kKEYPAD 56 kKEYPAD 6
  145. 7 kKEYPAD 78 kKEYPAD 7
  146. 9 kKEYPAD 90 kKEYPAD 0
  147. + kKEYPAD PLUS- kKEYPAD MINUS
  148. . kKEYPAD PERIODnscNO SCROLL
  149. escESCAPElfdLINE FEED
  150. entENTERaltALT
  151. upCURSOR UP *dwnCURSOR DOWN *
  152. lftCURSOR LEFT *rgtCURSOR RIGHT *
  153. * oN THE 128, THE CURSOR KEYS ON THE UPPER LEVEL OF THE KEYBOARD CAN BE DEFINED SEPARATELY FROM THOSE ON THE MAIN KEYBOARD.
  154. (MORE) =>
  155.  @aPPENDIX c
  156. uNSHIFTED kEY vALUES
  157. (IN THE ORDER THEY APPEAR IN THE LOOKUP MATRIX)
  158. DELRETCRTF7F1F3F5CDN
  159. $1D$0D$1E$0E$01$03$05$11
  160. 3WA4ZSE---
  161. $33$77$61$347A$73$65---
  162. 5RD6CFTX
  163. $35$72$64$36$63$66$74$78
  164. 7YG8BHUV
  165. $37$79$67$38$62$68$75$76
  166. 9IJ0MKON
  167. $39$69$6A$30$6D$6B$6F$6E
  168. +PL-.:@,
  169. $2B$70$6C$2D$2E$3A$40$2C
  170. LB*;HOM---=?/
  171. $08$2A$3B$12---$3D$5E$2F
  172. 1BAC---2SPC---QSTP
  173. $31$14---$32$20---$71$16
  174. 128 vERSION oNLY:
  175. HLP85TAB2471
  176. $19$38$35$09$32$34$37$31
  177. ESC+-LFDENT693
  178. $1B$2B$2D$0A$0B$36$39$33
  179. ALT0.UPDWNLFTRGTNSC
  180. $1A$30$2E$10$11$08$1E$07
  181. (MORE) =>
  182.  @aPPENDIX d
  183. sHIFTED kEY vALUES
  184. (IN THE ORDER THEY APPEAR IN THE LOOKUP MATRIX)
  185. insretclff8f2f4f6cup
  186. $1C$0D$08$0F$02$04$06$10
  187. #wa$zse---
  188. $23$57$41$24$5A$53$45---
  189. %rd&cftx
  190. $25$52$44$26$43$46$54$58
  191. 'yg(bhuv
  192. $27$59$47$28$42$48$55$56
  193. )ij0mkon
  194. $29$49$4A$30$4D$4B$4F$4E
  195. +pl->[@<
  196. $2B$50$4C$2D$3E$5B$40$3C
  197. lb*]clr---=^?
  198. $18$2A$5D$13---$3D$5E$3F
  199. !bac---"spc---qrun
  200. $21$14---$22$20---$51$17
  201.  @128 vERSION oNLY:
  202. hlp85tab2471
  203. $19$38$35$09$32$34$37$31
  204. esc+-lfdent693
  205. $1B$2B$2D$0A$0B$36$39$33
  206. alt0.updwnlftrgtnsc
  207. $1A$30$2E$10$11$08$1E$07
  208.  @aPPENDIX e
  209. gEOS ascii cODES ($01-$3F)
  210. kEYhEXdEC
  211. F1$011
  212. f2$022
  213. F3$033
  214. f4$044
  215. F5$055
  216. f6$066
  217. NSC$077128 ONLY
  218. CLF$088
  219. TAB$099128 ONLY
  220. LFD$0A10128 ONLY
  221. ENT$0B11128 ONLY
  222. $0C12NO APPARENT gEOS FUNCTION
  223. RET$0D13
  224. F7$0E14
  225. f8$0F15
  226. CUP$1016
  227. CDN$1117
  228. HOM$1218
  229. clr$1319
  230. BAC$1420
  231. $1521NO APPARENT gEOS FUNCTION
  232. STP$1622
  233. run$1723
  234. LB$1824
  235. HLP$1925128 ONLY
  236. ALT$1A26128 ONLY
  237. ESC$1B27128 ONLY
  238. ins$1C28
  239. DEL$1D29
  240. CRT$1E30
  241. $1F31      shift,
  242. ,ctrl (NOT SUPPORTED BY kEYmAKER)
  243. SPC$2032
  244. !$2133
  245. "$2234
  246. #$2335
  247. $$2436
  248. %$2537
  249. &$2638
  250. '$2739
  251. ($2840
  252. )$2941
  253. *$2A42
  254. +$2B43
  255. ,$2C44
  256. -$2D45
  257. .$2E46
  258. /$2F47
  259. 0$3048
  260. 1$3149
  261. 2$3250
  262. 3$3351
  263. 4$3452
  264. 5$3553
  265. 6$3654
  266. 7$3755
  267. 8$3856
  268. 9$3957
  269. :$3A58
  270. ;$3B59
  271. <$3C60
  272. =$3D61
  273. >$3E62
  274. ?$3F63
  275. (MORE) =>
  276.  @aPPENDIX e (CONT)
  277.  gEOS ascii cODES $40-$7E
  278. kEYhEXdEC
  279. @$4064
  280. a$4165
  281. b$4266
  282. c$4367
  283. d$4468
  284. e$4569
  285. f$4670
  286. g$4771
  287. h$4872
  288. i$4973
  289. j$4A74
  290. k$4B75
  291. l$4C76
  292. m$4D77
  293. n$4E78
  294. o$4F79
  295. p$5080
  296. q$5181
  297. r$5282
  298. s$5383
  299. t$5484
  300. u$5585
  301. v$5686
  302. w$5787
  303. x$5888
  304. y$5989
  305. z$5A90
  306. [$5B91
  307. \$5C92
  308. /  (NOT SUPPORTED BY kEYmAKER)
  309. ]$5D93
  310. ^$5E94
  311. _$5F95
  312.  -  (NOT SUPPORTED BY kEYmAKER)
  313. {$60}$6096
  314.  @  (NOT SUPPORTED BY kEYmAKER)
  315. A$6197
  316. B$6298
  317. C$6399
  318. D$64100
  319. E$65101
  320. F$66102
  321. G$67103
  322. H$68104
  323. I$69105
  324. J$6A106
  325. K$6B107
  326. L$6C108
  327. M$6D109
  328. N$6E110
  329. O$6F111
  330. P$70112
  331. Q$71113
  332. R$72114
  333. S$73115
  334. T$74116
  335. U$75117
  336. V$76118
  337. W$77119
  338. X$78120
  339. Y$79121
  340. Z$7A122
  341. {$7b}$7B123
  342.  :  (NOT SUPPORTED BY kEYmAKER)
  343. {$7c}$7C124
  344.  ^  (NOT SUPPORTED BY kEYmAKER)
  345. {$7d}$7D125
  346.  ;  (NOT SUPPORTED BY kEYmAKER)
  347. {$7e}$7E126
  348.  *  (NOT SUPPORTED BY kEYmAKER)
  349. nl2@
  350. nl2@
  351. i&D4 
  352.